Deletes a named fork of a file or directory.

void PBDeleteForkAsync (
    FSForkIOParam *paramBlock
);

paramBlock

A pointer to a parameter block.

DISCUSSION

The relevant fields of the parameter block are:

• ioCompletion

  On input, a pointer to a completion routine.

• ioResult

  On output, the result code of the function. If the named fork does not exist, errFSForkNotFound is returned.

• ref

  On input, the file or directory.

• forkNameLength

  On input, the length of the fork name in Unicode characters.

• forkName

  On input, the name of the fork to delete (in Unicode).

• permissions

  This field may be modified.

• forkRefNum

  This field may be modified.

• positionMode

  This field may be modified.

• positionOffset

  This field may be modified.

Any storage allocated to the fork is released.

If a given fork always exists for a given volume format (such as data and resource forks for HFS and HFS Plus, or data forks for most other volume formats), this is equivalent to setting the logical size of the fork to zero.

AVAILABILITY

Supported in Carbon. Available in Mac OS 9, and later when Carbon 1.0.2 or later is present.

© 2000 Apple Computer, Inc. — (Last Updated 5/8/2000)